home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / netmail / admsg120.zip / ADMSG.TXT < prev    next >
Text File  |  1996-02-02  |  17KB  |  517 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                   AnDan Software Message Generator Version 1.20
  25.  
  26.                   Users Manual
  27.  
  28.                   Scandinavian Digital Systems           AnDan Software Message Generator Version 1.20        Users Manual
  29.           ─────────────────────────────────────────────────────────────────
  30.  
  31.  
  32.           Table of contents
  33.  
  34.            1  Overview ...............................................    3
  35.            2  Shareware ..............................................    3
  36.               2.1  Use as shareware ..................................    3
  37.               2.2  How to register ...................................    3
  38.            3  Support and new versions ...............................    4
  39.            4  Included files .........................................    4
  40.            5  Installation ...........................................    5
  41.            6  Command line arguments .................................    5
  42.            7  Execution examples .....................................    6
  43.            8  Version history ........................................    8
  44.  
  45.  
  46.           Copyright (c) 1991-1996 Scandinavian Digital Systems AB
  47.  
  48.           This product, including the manual and the software, is provided
  49.           as is. Scandinavian Digital Systems AB and Anders Danielsson
  50.           disclaims all warranties of any kind, whether expressed or
  51.           implied, and are not liable to you or anyone else for any damages
  52.           or costs due to the use or inability to use this product.
  53.  
  54.           Acknowledgments:
  55.  
  56.           AnDan Software is a trademark of Scandinavian Digital Systems AB.
  57.           FidoNet is a trademark of Tom Jennings.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.           ─────────────────────────────────────────────────────────────────
  89.           Scandinavian Digital Systems                               Page 2           AnDan Software Message Generator Version 1.20        Users Manual
  90.           ─────────────────────────────────────────────────────────────────
  91.  
  92.  
  93.           1  Overview
  94.  
  95.           AnDan Software Message Generator (ADMsg) is a program that
  96.           generates FidoNet netmail messages (*.MSG files).
  97.  
  98.           It can generate messages in many different ways, including
  99.           combining lists of destination addresses and list of subject
  100.           lines (subject lines are used for file attach and request).
  101.  
  102.           ADMsg comes in both a DOS version for 386 or newer, and in a
  103.           32-bit OS/2 version.
  104.  
  105.           ADMsg was previously called Msggen.
  106.  
  107.  
  108.           2  Shareware
  109.  
  110.           The files in this package may be copied and distributed if no fee
  111.           is charged, if no changes are done and as no part of other
  112.           products, in purpose to test and evaluate this product for a
  113.           period of 30 days.
  114.  
  115.  
  116.           2.1  Use as sharewere
  117.  
  118.           To use ADMSG.EXE as shareware, you must first execute the
  119.           supplied REGISTER.EXE and register ADMSG.EXE as shareware.
  120.  
  121.           Run REGISTER.EXE, specify ADMSG.EXE (or ADMSG.OS2) as file to
  122.           register and do not enter any user name. ADMSG.EXE may then be
  123.           used as shareware.
  124.  
  125.           When ADMSG.EXE is executed it will display the number of days
  126.           since it was registered as shareware.
  127.  
  128.  
  129.           2.2  How to register
  130.  
  131.           To register ADMsg and use it for more than 30 days, you must pay
  132.           60 SEK, DM 15, UKP 5 or an amount equal to the sum of USD 10 in a
  133.           currency of your own choice.
  134.  
  135.           You can either send cash to (print REGISTER.TXT):
  136.  
  137.                   Scandinavian Digital Systems AB
  138.                   Billerudsgatan 20
  139.                   S-661 30  Saffle
  140.                   SWEDEN
  141.  
  142.           or you can deposit the amount to the Swedish postal giro account
  143.           970159-0.
  144.  
  145.           Please include a note or a postcard, with your FidoNet or
  146.           Internet e-mail address, and you will receive an e-mail receipt
  147.  
  148.  
  149.           ─────────────────────────────────────────────────────────────────
  150.           Scandinavian Digital Systems                               Page 3           AnDan Software Message Generator Version 1.20        Users Manual
  151.           ─────────────────────────────────────────────────────────────────
  152.  
  153.  
  154.           of your deposit.
  155.  
  156.           After depositing the fee, send an electronic mail through FidoNet
  157.           to Reg at 2:203/620 or through Internet to reg@andan.edv.se. The
  158.           mail should contain the following lines:
  159.  
  160.                   Prod=ADMsg
  161.                   User=<Your name and your e-mail address, BBS or location>
  162.  
  163.           You will then recieve an automatic reply with your private
  164.           registration code, to the address you mailed your registration.
  165.  
  166.           When you specify your user registration name after the "User=",
  167.           you should use your name together with some kind of address or
  168.           location information. Examples:
  169.  
  170.                   User=Anders Danielsson, AnDan BBS, 2:203/620
  171.                   User=Charles Smith, cs@someplace.com
  172.                   User=Hans Schultz, Dernauer Str., Hamburg, Germany
  173.  
  174.           Use at least 16 characters, but not more than 63 characters.
  175.  
  176.           You may also phone AnDan BBS at +46-533-13700 and register
  177.           on-line. The on-line registration is similar to the mail
  178.           registration.
  179.  
  180.           E-mail registration replies through FidoNet are routed. Routed
  181.           FidoNet mail may not work on long distances. If you don't want
  182.           routed mail, use the on-line registration.
  183.  
  184.  
  185.           3  Support and new versions
  186.  
  187.           If you have questions, comments or find bugs in the program,
  188.           please send electronic mail to the author, Anders Danielsson at
  189.           FidoNet 2:203/620 or ad@andan.edv.se.
  190.  
  191.           Well documented reports of new bugs and suggestions are honored
  192.           with a free registration.
  193.  
  194.           The latest version can be file requested as ADMSG from FidoNet
  195.           2:203/620.
  196.  
  197.           You may also phone AnDan BBS at +46-533-13700, where the newest
  198.           versions and other shareware programs from AnDan Software always
  199.           are downloadable for all users.
  200.  
  201.  
  202.           4  Included files
  203.  
  204.           You should have received the following files:
  205.  
  206.  
  207.  
  208.  
  209.  
  210.           ─────────────────────────────────────────────────────────────────
  211.           Scandinavian Digital Systems                               Page 4           AnDan Software Message Generator Version 1.20        Users Manual
  212.           ─────────────────────────────────────────────────────────────────
  213.  
  214.  
  215.           File name:    Description:
  216.  
  217.           ADMSG.TXT     This file
  218.           ADMSG.EXE     The DOS version of ADMsg
  219.           ADMSG.OS2     The OS/2 version of ADMsg
  220.           FILE_ID.DIZ   File description
  221.           REGISTER.TXT  Registration form
  222.           REGISTER.EXE  Registration program (runs on both DOS and OS/2)
  223.  
  224.  
  225.           5  Installation
  226.  
  227.           If you want to use the DOS version, just copy ADMSG.EXE to a
  228.           directory included in your PATH.
  229.  
  230.           If you want to use the OS/2 version, copy ADMSG.OS2 to a
  231.           directory included in your PATH, and rename it to ADMSG.EXE.
  232.  
  233.           If you want to use both the DOS and the OS/2 version, do as
  234.           above, and keep the PATHs different in DOS and OS/2 sessions.
  235.  
  236.           For example, in OS/2's CONFIG.SYS you may have:
  237.  
  238.           SET PATH=C:\OS2BIN;C:\OS2;C:\OS2\MDOS;...
  239.  
  240.           And in AUTOEXEC.BAT you may have:
  241.  
  242.           PATH=C:\DOSBIN;C:\OS2;C:\OS2\MDOS;...
  243.  
  244.           The DOS version of ADMsg is stored in C:\DOSBIN and the OS/2
  245.           version in C:\OS2BIN.
  246.  
  247.  
  248.           6  Command line arguments
  249.  
  250.           ADMsg has a rather complex command line syntax. It is mainly
  251.           executed from DOS .BAT files or from OS/2 .CMD files, to automate
  252.           message generations for different purposes.
  253.  
  254.           To make ADMsg easier to use manually from the prompt, it will
  255.           ask you for all arguments needed, if any arguments are missing,
  256.           or if you run ADMsg without any arguments at all.
  257.  
  258.           If you run ADMsg with the option /? it will display the
  259.           following help text (use "admsg /? | more" for more prompt):
  260.  
  261.           admsg netpath origin from dest to flags [subj] [message] [/c]
  262.             [/N]
  263.  
  264.           netpath   Path to the netmail directory with *.MSG files.
  265.  
  266.           origin    Origin address, zone:net/node.point, and default
  267.                     destination zone, net and node. If zone is not used,
  268.                     the ^AINTL line will not be used.
  269.  
  270.  
  271.           ─────────────────────────────────────────────────────────────────
  272.           Scandinavian Digital Systems                               Page 5           AnDan Software Message Generator Version 1.20        Users Manual
  273.           ─────────────────────────────────────────────────────────────────
  274.  
  275.  
  276.           from      From name, within " and " if space is used.
  277.  
  278.           dest      Destination address or @filename with each line
  279.                     containing:
  280.  
  281.                       zone:net/node.point "Optional to name"
  282.  
  283.           to        Default to name, within " and " if space is used.
  284.  
  285.           flags     Message flags, one or more letters of:
  286.  
  287.                       P   Private
  288.                       C   Crash
  289.                       H   Hold
  290.                       F   File
  291.                       R   File request
  292.                       U   Update request
  293.                       K   Kill/sent
  294.                       T   Trunc/sent (extended flag)
  295.                       E   Delete/sent (extended flag)
  296.                       D   Direct (extended flag)
  297.                       I   Immediate mail (extended flag)
  298.                       Z   No flags
  299.  
  300.           subj      Subject within " and " or @filename with each line
  301.                     containing:
  302.  
  303.                       Subject (usually filename to request or send)
  304.  
  305.           message   Optional message text within " and " or @filename for a
  306.                     text file.
  307.  
  308.           /c        Conditional, will generate a message only if no not
  309.                     sent message with the same origin and destination net
  310.                     and node, and from and to name exists.
  311.  
  312.           /N        N is a number. Moves N lines from the subject file, and
  313.                     generate messages with those lines.
  314.  
  315.           ADMsg generates netmail messages (*.MSG files). The dest and
  316.           subj files may have comment lines starting with ;. ADMsg will
  317.           create a message for each subject to each destination. A ? may be
  318.           used as any argument, in this case ADMsg will ask for that
  319.           argument. Missing arguments will also be asked for.
  320.  
  321.  
  322.           7  Execution examples
  323.  
  324.           admsg
  325.  
  326.               ADMsg will ask you for each argument needed.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.           ─────────────────────────────────────────────────────────────────
  333.           Scandinavian Digital Systems                               Page 6           AnDan Software Message Generator Version 1.20        Users Manual
  334.           ─────────────────────────────────────────────────────────────────
  335.  
  336.  
  337.           ADMsg c:\msg 2:203/620 "Anders Danielsson" ? ? ? ? ?
  338.  
  339.               Mail will be sent from Anders Danielsson at 2:203/620. C:\MSG
  340.               contains the netmail messages. What to send and to whom will
  341.               be asked for by ADMsg. This example is suitable to use in a
  342.               .BAT or .CMD file for sending messages manually with the same
  343.               origin. If the question marks are omitted, Msgen will not ask
  344.               for the subject and message text, because these are optional.
  345.  
  346.  
  347.           admsg c:\fd\mail 2:203/620 "Anders Danielsson" 201/209 Sysop PKC
  348.           Hello @letter.txt
  349.  
  350.               Send a crash mail from Anders Danielsson at 2:203/620 to
  351.               Sysop at 2:201/209 with the subject "Hello" and the message
  352.               text in the file LETTER.TXT.
  353.  
  354.  
  355.           admsg c:\msg 2:203/620 "Anders Danielsson" .11 "Fredrik" PKF
  356.           c:\a1f\andan.zip
  357.  
  358.               Send the file C:\A1F\ANDAN.ZIP to Fredrik at 2:203/620.11.
  359.  
  360.  
  361.           admsg c:\msg 2:203/620 Sysop .11 Fredrik PKF ?
  362.  
  363.               ADMsg will ask for a file to send to Fredrik at
  364.               2:203/620.11.
  365.  
  366.  
  367.           admsg c:\msg 2:203/620 Sysop .11 Fredrik PKF ? ?
  368.  
  369.               ADMsg will ask for a file and message to send to Fredrik at
  370.               2:203/620.11.
  371.  
  372.  
  373.           admsg c:\msg 2:203/620.1 Sysop @nodes.lst Sysop PKFD
  374.           c:\a3f\sds0901.zip @letter.txt
  375.  
  376.               Send directly a file and message to all nodes in NODES.LST.
  377.               Example of NODES.LST:
  378.  
  379.               ;
  380.               ; NODES.LST (lines begining with ; are comment lines)
  381.               ;
  382.               2:203/620.11 Fredrik Danielsson
  383.               2:203/104    "Anders Ekman"         Comments...
  384.               BBS          Lines begining with "BBS" are also ignored
  385.               ;
  386.  
  387.  
  388.           admsg c:\msg 2:203/620 Sysop 104 Sysop PKRC @req.lst
  389.  
  390.  
  391.  
  392.  
  393.           ─────────────────────────────────────────────────────────────────
  394.           Scandinavian Digital Systems                               Page 7           AnDan Software Message Generator Version 1.20        Users Manual
  395.           ─────────────────────────────────────────────────────────────────
  396.  
  397.  
  398.               Make a file request from 2:203/104 with crash status of all
  399.               files listed in REQ.LST. Example of REQ.LST:
  400.  
  401.               ADMSG120.ZIP
  402.               ADF_131.ZIP
  403.  
  404.  
  405.           admsg c:\msg 2:203/620 Sysop @nodes.lst Sysop PKF @send.lst
  406.           @letter.txt
  407.  
  408.               Send all files listed in SEND.LST and the message in
  409.               LETTER.TXT to all nodes in NODES.LST.
  410.  
  411.  
  412.           admsg c:\msg 2:203/620 ADMsg 201/209 Sysop PKRD @201_209.req /c
  413.           /4
  414.  
  415.               Make a file request from 2:201/209 with direct status of the
  416.               4 first files listed in 201_209.REQ (if each line contains
  417.               one file name), if there is no other message from ADMsg at
  418.               203/620 and to Sysop at 201/209 in the netmail directory. The
  419.               4 lines in 201_209.REQ are removed if the messages was
  420.               generated. Use for example "if exist 201_209.req admsg ..."
  421.               in the mailer .BAT or .CMD file after mail has been received
  422.               for automatic request from system with request limits.
  423.  
  424.  
  425.           8  Version history
  426.  
  427.           v1.00, September 25, 1991
  428.  
  429.           First release.
  430.  
  431.  
  432.           v1.01, February 2, 1993
  433.  
  434.           Will use the ^AINTL line even if the zones are the same. To avoid
  435.           the ^AINTL line, do not specify any zones.
  436.  
  437.  
  438.           v1.02, July 20, 1994
  439.  
  440.           Added the ^AMSGID line. Changed date format in .MSG-header so
  441.           always two digits are used for day of months (01 instead of 1).
  442.  
  443.  
  444.           v1.10, November 24, 1995
  445.  
  446.           Program rewritten, OS/2 32-bit version included. Input of
  447.           arguments from the keyboard. " and " may be used around to names
  448.           in destination files.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.           ─────────────────────────────────────────────────────────────────
  455.           Scandinavian Digital Systems                               Page 8           AnDan Software Message Generator Version 1.20        Users Manual
  456.           ─────────────────────────────────────────────────────────────────
  457.  
  458.  
  459.           v1.20, February 2, 1996
  460.  
  461.           The time limit of 30 days after installation has been removed.
  462.           ADF will not stop executing after 30 days as before, it will run
  463.           for ever, even if it is never registered.
  464.  
  465.           More individual MSGID. Date written and date arrived set to zero
  466.           in message header to work with programs using these as zone and
  467.           point addresses. Replaced tear line with ^APID line. Renamed from
  468.           Msggen to ADMsg. Include terminating '\0' in written msg.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.           ─────────────────────────────────────────────────────────────────
  516.           Scandinavian Digital Systems                               Page 9
  517.